home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu721.dms / pu721.adf / OtherDocs / EPU.Doc < prev    next >
Text File  |  1978-05-02  |  10KB  |  291 lines
  1.  
  2.                               =================
  3.                               EPU Stakker v1.62
  4.                               =================
  5.  
  6.  
  7.  
  8.  
  9. Description
  10. ===========
  11.  
  12. After installing EPU to any Device (HardDisk,Floppy,Rad etc) every file 
  13. which will be written to the device will be compressed and when any 
  14. compressed file is read by any application it will be automaticaly 
  15. decompresed. 
  16.  
  17. EPU is very easy to install or remove, its size is very small, can work with
  18. many compress libraries like lh.library or xpk(NUKE,...).  
  19.  
  20. The file sizes are not limited by memory, (maximum file size is about 1GB).
  21.  
  22. There are no differences or limitations when you are working with installed 
  23. epu or without it (of course it can be slower if the CPU is slow.) 
  24.  
  25.  
  26. The EPU command syntax -  from CLI:
  27.  
  28. EPU DEVICE name [SAVE/NOSAVE] [LOAD/NOLOAD] [EXAMINE/NOEXAMINE] 
  29.  [NoExNext/ExNext] [LMODE/HMODE] [BLOCK number] [TABLE Number] [LIBRARY name]
  30.  [INFO/CHNG/KILL]
  31.  
  32.  DEV is the synonym of DEVICE
  33.  LIB is the synonym of LIBRARY
  34.  
  35.   
  36. options:
  37.      
  38. NoSave    - when  creating new file under epu, it will not be compresed 
  39.             (simply packet ACTION_FINDOUTPUT is ignored); [file will not be 
  40.             compressed, when saving]
  41.      
  42. Save      - default option : file will be compresed every time.
  43.  
  44. NoLoad    - when accessing file compressed by EPU system, it will not be
  45.             decompressed(simply packet ACTION_FINDINPUT is ignored); Useful 
  46.             when EPU is still instaled and you want to copy some EPU file 
  47.             (epu file is file which is in epu compress format) to another 
  48.             place without decompressing.
  49.      
  50. Load      - default option : Epu file will be decompressed every time.
  51.  
  52.      
  53. Examine   - Default option : when  examining EPU file (for example list 
  54.             c:dir) you will get its virtual file size( that mean the size 
  55.             what you get after decompressing). 
  56.      
  57. NoExamine - When examining EPU file  you will get its real size on the disk
  58.             (simply packet ACTION_EXAMINE is ignored);
  59.  
  60.      
  61. ExNext    - Default option : when examining directory contents ( f.e. list 
  62.             c:) you will get virtual file sizes of files in this directory.
  63.      
  64. NoExNext  - When examining directory contents you will get real file sizes 
  65.             of files in this directory (simply packet ACTION_EXNEXT is 
  66.             ignored);
  67.      
  68.      
  69. Hmode     - Default option: when file is saved (opened by opt MODE_NEWFILE)
  70.         EPU system will look whether the first compressed part is bigger
  71.             than before compressing and if so EPU will not create standart 
  72.             EPU file but will save it as normal file. That means when saving
  73.             once compressed file it will not be compressed again.
  74.      
  75. Lmode     - When saving file, it will allways be created in standard EPU
  76.             format.
  77.   
  78. parameters:  
  79.      
  80. BLOCK     - sets block size for file which can be between 2 - 60 Kb.
  81.             Default size is 10. When a small size is choosen you will need 
  82.             less memory, but speed and compression ratio can be worse.
  83.             When you set BLOCK 20 you will need 2*20Kb for opened file.
  84.  
  85. TABLE       - sets maximum of blocks for one opened file. Default size is 
  86.             1000 (can be betwee 500 - 20000 ). So when block size is 20 and
  87.             table is 1000 the file size can be maximal 20 MB large (20*1000
  88.             *1000 Bytes)
  89.  
  90.      
  91. LIBRARY   - default epu0: Here can be specified which compression/
  92.             decompression library will be used to pack the file. There are 
  93.             only two libs in the package(epu0 and epu1). example:  lib epu0
  94.             or lib epu1 BUT do not forget that epu can now work with all XPK
  95.             packer libs like NUKE(the best library)  HUFF SHRI  and so on.
  96.             example: lib NUKE or lib SHRI. These libs are included. 
  97.             Epu does not support libs which require password.
  98.  
  99.  
  100. The values of TABLE,LIBRARY and BLOCK are only used when creating new EPU 
  101. file, when opening old epu file, the values in its header are used. 
  102.  
  103. comms:
  104.      
  105. Info      - gives current epu setings for given device(if assigned by EPU)
  106.             when for example will be typed: EPU device rad info it will 
  107.             print something like this:
  108.  
  109.             STATUS:
  110.                        LOAD / SAVE / EXAM / EXNEXT / HMODE
  111.                        BLOCK:    10
  112.                        TABLE:    1000
  113.                        LIBRARY:  epu0
  114.  
  115. Chng      - current setings of epu can be changed. For example, EPU dev rad
  116.             NoSave Load Block 20 chng will change block size to 20 and sets
  117.             options to NoSave, Load; the other setings will be unchanged.
  118.  
  119. Kill      - Removes EPU from device. For example, EPU dev rad kill will 
  120.             remove EPU system from rad device. When some files are opened 
  121.             under EPU when killing it, the epu will wait till all this files
  122.             will be closed and then will kill itself (in this waiting time 
  123.             can't be epu installed  again).
  124.  
  125. When no command is given epu will try to install to given device.
  126.  
  127. --------------------------------------------------------------------
  128.  
  129. There can appear 2 new I/O error messages when working under epu:
  130.  
  131. 1) ERROR_BAD_FILE - its number is 3020 . 
  132.    This error means that the epu file is not valid(damaged etc.).
  133.  
  134. 2) ERROR_OPEN_UNPOSSIBLE -its number is 3021 .
  135.    This error means that the file can't be opened because of there is no mem
  136.    to allocate buffers or epu can't open compress library  which the file 
  137.    requires.
  138.  
  139. ---------------------------------------------------------------------
  140. Recomp:
  141.  
  142. In the util directory you can find program Recomp. It can help you to 
  143. compress the files on your (Hard)disk or recompress them by another library.
  144. It's simple but can be usefull. Read the Recomp.doc.
  145.  
  146. ----------------------------------------------------------------------
  147. Notices:
  148.  
  149. EPU cli command can be loaded resident. The EPU handlers are loaded resident
  150. to memory after first using of EPU command.
  151.  
  152. Instead of the name of device you can type name of volume, then the epu will
  153. be installed to the device in which  the volume is inserted. It's usefull 
  154. when epu command is used in startup sequence and we do not know which drive
  155. will be used to boot.
  156.  
  157. Epu do not change any library vector(so others programs which access device
  158. directly ,without using dos.library, are also handled)
  159.  
  160. When the file is compressed(decompressed) the device is not blocked and can
  161. be used by anothers programs.
  162.  
  163. Example how compress your Workbench disk to save about 300Kb space (size of
  164. saved space depends on library you have used to compress files). You must 
  165. first compress all files(Icons/libraries/progs. etc.) to blank disk. You 
  166. can't only compress files that are used before executing startup sequence
  167. (that is system-configuration and startup-sequence) they must be 
  168. uncompressed. The last step is to change the startup-sequence. At the first
  169. line you must write: EPU dev volume-name and now you can boot from this 
  170. disk. Of course you can compress any others disks or hard disk by this way.
  171.  
  172. I used this method to compress Workbench 1.3.(epu1.library used). After 
  173. compressing all files and installing epu about 300KB remained free on the 
  174. disk.That mean I was able to store about 400 KB large files from Extras 
  175. disk on Workbench disk !!!!!!!!
  176.  
  177. epu0.library - this library is based on LZSS algor.. That mean the 
  178. compression is slow,but decompression is fast enought. The compression ratio
  179. is also nothing special. 
  180.  
  181. epu1.library - it is the interface between epu and lh.library. The 
  182. compression ratio is very good(better than PowerPacker) ,the speed too.
  183. [lh.library is the product of O. Barthel & P. Krekel , you can find it on
  184. Fish disk with documentation]
  185.  
  186.  I SUGGEST TO USE THE NUKE LIBRARY - IT'S THE BEST
  187.  
  188. Testing:
  189.  
  190. EPU works with 2.0 and 3.0 filesystem, fastfilesystem, rad and other 
  191. standard devices.
  192.  
  193. EPU does not currently work with 2.0. ram: device.
  194.  
  195. Do not also install epu to devices which do not support Seek and Lock 
  196. packets (PIPE,NULL).
  197.  
  198. WARNING:
  199.   
  200. You are using this program on your own risk.
  201.  
  202.    
  203. You can send bugs,new ideas,opinions to this internet e-mail address
  204.  
  205.     jara@adelard.dcs.muni.cs  
  206.     jara@lion.ics.muni.cs
  207.   
  208.   or you can write to:
  209.  
  210.      J. Mechacek
  211.     Mutenicka 7
  212.     628 00 Brno
  213.     Czech Republic
  214.         Europe
  215.  
  216. or send EMail to Northern Amiga Users Group
  217.  
  218.     bux8@unn.ac.uk
  219.  
  220. P.O. Box 151
  221. Darlington
  222. County Durham
  223. DL3 8YT
  224.  
  225.     
  226.  
  227.  
  228.  
  229. DISTRIBUTABILITY:
  230.  
  231. Can be distributed as shareware - all unchanged files must be included with
  232. this disk, including the installer and all documents.
  233.  
  234.  
  235.                      How to register
  236.                      ===============
  237.  
  238.  
  239.  
  240. Epu 1.62 is SHAREWARE , so if you use it you should send US $20
  241.                                                         ------
  242. There is also an special offer how to get the Epu2.0 which will not be
  243. Shareware:                                                 -----------
  244.  
  245.   - if you pay $20 to 30 October 1993 you will receive Epu2.0 free.
  246.     ( I prefer to send it by e-mail so don't forget to write it )
  247.                          
  248.   - if you pay $20 to 30 June 1993 you will receive all Epu versions
  249.     which will be released - but you must have an e-mail address :
  250.     the Epu2.0 you will receive on the disk if you do not have e-mail
  251.     address but the next versions will be only e-mailed. 
  252.  
  253. Fill and send(e-mail) me this registration form:
  254.  
  255. -------------------------------------------------
  256. Name:
  257. Address:
  258. e-mail:
  259. Date when you sent the registration fee:
  260.  
  261. (Hardware):
  262. (Notices):
  263. -------------------------------------------------
  264.  
  265. Where to send the fee:
  266.  
  267.   1)
  268. Account Name: Jaroslav Mechacek,Mutenicka 7
  269. Account Number: 34278-314558-621
  270. Bank address:      
  271.      Commercial Bank
  272.     Brno-mesto
  273.     nam. Svobody 21
  274.     631 31 Brno
  275.     Czech Republic
  276.     Europe
  277.        
  278.  
  279.   2) Send the fee in insured registered letter to this address:
  280.        
  281.     J. Mechacek
  282.     Mutenicka 7
  283.     628 00 Brno
  284.     Czech Republic
  285.         Europe
  286.  
  287.  DO NOT USE ANY OTHER WAY 
  288.  
  289.  
  290.  
  291.